home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 685 / connect / docs / connect.txt next >
Text File  |  1989-04-05  |  21KB  |  414 lines

  1.                               Connections 1.0
  2.                       ---------------------------------
  3.                       Interactive Multimedia Networking
  4.                          Copyright 1992, David Becker
  5.                            Compuserve 73030,3562
  6.                               GEnie D.Becker8
  7.  
  8. Preface
  9. -------
  10. Linking text, graphics, animation and sound within interactive multimedia
  11. presentations is not a new idea. Hypercard on the Macintosh has been doing it
  12. for years. Many commercial programs exist for the PC as well. 
  13.  
  14. I wanted to create a simple tool that would allow any user, adult or child, to
  15. quickly and easily create families of information. These families could be
  16. released in the public domain and shared by all ST users. They would be
  17. interactive, informative, educational, instructive, entertaining and fun to
  18. use.
  19.  
  20. I'd like to port Connections over to the Falcon. This would truly bring simple,
  21. photo-realistic, CD quality multimedia creation into the home. Exciting
  22. possibilities lie in the future but lets look at what I've accomplished to 
  23. date. I hope, with feedback from the Atari community (that means you) we can 
  24. mold Connections into an exciting, full featured multimedia platform for the 
  25. Atari computer.
  26.  
  27. Users must be able to share, run and enjoy each others creations without cost,
  28. therefore Connections is freeware. You may distribute it, copy it, share it,
  29. sell it through the user group or upload it to your local BBS. Please make sure
  30. the files and documentation remain intact and unchanged. Connections version 
  31. 1.0 requires a monochrome monitor. You should have at least one megabyte of 
  32. memory and a hard drive.
  33.  
  34.  
  35. What does it do?  
  36. ----------------
  37. Connections links the following multimedia family members into your own custom 
  38. interactive presentation with graphics, text files, sounds and animation:
  39.  
  40.     *   Digitized sounds (Replay format using the extension .SPL)
  41.  
  42.     *   Degas full size parent screens (using the .PI3 extension)
  43.  
  44.     *   Smaller graphic picture blocks (using the extension .DAT)
  45.  
  46.     *   Multiple block animation files (with the extension .ANI)
  47.  
  48.     *   Standard ASCII text files (up to 80 columns with the extension .TXT)
  49.  
  50.     *   External applications (run other programs .PRG from within a family)
  51.  
  52. Multimedia children are accessed from a parent screen. This is always a full
  53. size Degas .PI3 picture with icons, arrows, buttons or any prompts you desire
  54. painted on the screen.
  55.  
  56. With the Connections creation program, you will choose point and click
  57. buttons on the parent screen that users can activate with the mouse and in
  58. turn call forth multimedia children. Parent screens can also call upon other
  59. parent screens, each with their own set of children. Thus we have an infinite
  60. array of multimedia information screens, sounds, animations and text files,
  61. branching out just like a family tree, limited only by your imagination and
  62. disk space!
  63.  
  64. Lets imagine a theoretical Connections family just for the fun of it. A class
  65. of school children may wish to introduce themselves to other ST users through a
  66. Connections family. They would start with a parent screen containing a title
  67. and a class picture. Each one of the individual students within this screen can
  68. be defined as a point and click button. When a user clicks over top of any
  69. student, the connection is made to another parent screen about that specific
  70. student. This second parent screen can have icons painted on it that when
  71. clicked upon will reproduce the students voice, an animation of the student in
  72. gym class or perhaps some smaller pictures of the students pets and hobbies.
  73. You could attach a text file describing this students home life or other
  74. interests. Finally you would define an icon that would return the user to the
  75. very first parent screen, so that another student could be chosen.
  76.  
  77. Let your imagination run wild! There are more possible uses for this type of
  78. interactive multimedia network then there are minutes in a day! And if you 
  79. think creating your own families is going to be tough ... think again.
  80.  
  81.  
  82. Preparation
  83. -----------
  84. The Connections program won't draw your parent screens or graphic children for
  85. you. You will have to create these screens with your favorite paint program.
  86.  
  87. I've included a utility program on this disk that can grab blocks from your own
  88. .PI3 pictures and save them as graphic children or animations. You can also add
  89. text to these graphic children in a variety of type sizes. Read the
  90. documentation file included with this utility.
  91.  
  92. Digitized sound files can be created with the Replay cartridge (or compatible
  93. hardware) or found on Compuserve and GEnie. There are many PD utilities that
  94. will convert different format sound files to .SPL as well.
  95.  
  96. You may wish to borrow Degas pictures available online and add your own text
  97. and icons to them. Watch out for copyright material. There are some excellent
  98. PD conversion programs available that will change almost any graphic file into
  99. .PI3 format.
  100.  
  101. I usually map my Creations family on paper using a flowchart before I start
  102. drawing and collecting multimedia pieces. Creating the different graphic
  103. screens is a lot of fun and after having compiled all the sounds, animations,
  104. graphics and text files into a folder, the networking of this information is
  105. easy.
  106.  
  107. Let's run the Connections program and we'll give it a try. You can experiment
  108. with the family in the folder named PRACTICE available on this disk.
  109.  
  110.  
  111. -----------------------------------CREATION------------------------------------
  112.  
  113.  
  114. Networking a Creations Family
  115. -----------------------------
  116. When you first run CONNECT.PRG you will be presented with the main dialog box 
  117. and asked if you wish to CREATE or RUN a family. Click on CREATE and you will
  118. be asked to load the first parent screen.
  119.  
  120. The first screen within a Connections family MUST be named START.PI3
  121.  
  122. Double-click on START.PI3 within the PRACTICE folder and it will be displayed.
  123. This is a family created by our pet dog, Sasha. It didn't take her long to 
  124. learn Connections, and she can't type! 
  125.  
  126. You are now ready to create point and click buttons and link these buttons to
  127. multimedia children or to other parent screens. We define a point and click
  128. button by depressing the left mouse and dragging down and to the right. A
  129. rubber-band box will be displayed as you go. Let up the mouse button and the
  130. defined region will become inverted and a dialog box will be displayed asking
  131. you to choose a type of multimedia child.
  132.  
  133. Let's do it! Drag out an area over top of the SASHA'S PAL HUGO icon at the
  134. bottom of the screen and when the dialog appears, choose GRAPHIC CHILD. When
  135. the fileselector comes up, double-click on the graphic child file named
  136. HUGO.DAT and it will load and display. You can move this graphic around the
  137. screen with the mouse until you are happy with its position. Click the left
  138. mouse button to confirm or click the right mouse button to cancel and try
  139. again. That's all there is to it!
  140.  
  141.         I'll now explain each multimedia child's creation in detail:
  142.  
  143.                                 Sound Child
  144.                                 ===========
  145. Define a point and click button and then choose SOUND CHILD from the menu
  146. dialog. After loading the sample called BARK.SPL from disk you will be
  147. presented with another dialog box. Here you can listen to your sample, slow it
  148. down, speed it up, choose another sound if you goofed, decide how many times
  149. the sample will be looped (repeated) and finally when the sample and speed are
  150. correct confirm the connection.
  151.  
  152.                               Animation Child
  153.                               =============== 
  154. Animations are just a sequence of graphic blocks that when cycled, create the
  155. illusion of motion. They can be video snapshots, line drawings, cartoons, etc.
  156. but all use the same format as graphic children. You can cut out and create
  157. sequential blocks from Degas .PI3 pictures using the Connections utility
  158. included on this disk. All animation blocks must use the extension .ANI 
  159. Name the sequential blocks using descriptive text and numbers, for example:
  160.  
  161.                                 DOG_1.ANI
  162.                                 DOG_2.ANI
  163.                                 DOG_3.ANI
  164.                                 DOG_4.ANI
  165.                                 DOG_5.ANI
  166.                                 DOG_6.ANI
  167.  
  168. After defining a point and click button and choosing ANIMATION CHILD from the
  169. dialog, you must select each of the .ANI files from the fileselector, one at a
  170. time, in the exact order they are to be cycled through. Click CANCEL from the
  171. fileselector when done and you will next be able to place "frame one" of your
  172. animation on the screen using the mouse button. After it is placed down,
  173. the animation will immediately begin to cycle. You can use the up and down
  174. arrows to speed up and slow down the animation. When you are happy with the
  175. speed, click the left mouse again to confirm. To cancel and try all over again
  176. you can click the right mouse button.
  177.  
  178.                                 Text Child
  179.                                 ==========
  180. Define a point and click button and select TEXT CHILD from the dialog. Text
  181. files must be ASCII and can be any length. The width cannot exceed 80 columns.
  182. Choose the text file named BREEDS.TXT from the fileselector.
  183.  
  184. Your chosen text file will now be displayed inside its own window. Text files
  185. centre themselves automatically. You can use the up and down arrows to scroll
  186. one line at a time. Use the SHIFT-ARROWS to scroll one page at a time. You can
  187. also hit B to jump to the bottom of your text file or T for the top. The mouse
  188. buttons will also scroll the text up and down if the mouse pointer lies within
  189. the text window. If the mouse pointer is any place else, a left mouse click
  190. will confirm your connection and a right click will cancel it.
  191.  
  192.                                Graphic Child 
  193.                                =============
  194. We've already experimented with one graphic child. They can be any size from
  195. tiny to full screen. After defining a point and click button just position the
  196. graphic on the parent screen with the mouse, click the left button and
  197. Connections will remember its location and add it to the script. Use the right
  198. mouse button to cancel and choose again.
  199.  
  200.                             Other Parent Screens
  201.                             ====================
  202. You can define a point and click button to take you to another parent screen.
  203. This first family only has one parent screen but no doubt you'll be creating
  204. larger families in the future.
  205.  
  206. The new parent screen will be loaded and then displayed until you click the
  207. left mouse button to confirm or the right button to cancel. You can add
  208. multimedia children to the new parent screen later on.
  209.  
  210.                               Executable Child
  211.                               ================
  212. Here is a useful yet dangerous option, one you would probably not use if you
  213. planned on sharing Connections families with other users.  
  214.  
  215. By choosing EXECUTABLE CHILD after defining a button, you can run external
  216. programs, .PRG .APP .TOS from the parent screen.
  217.  
  218. Not all programs run correctly. Size, available memory, TOS versions and many
  219. other factors come into play here. Experiment, and don't forget others may not
  220. have the same program or the same system requirements! I have not included any
  221. executable children with the practice family.
  222.  
  223. You can connect a program to a point and click button but it will not be
  224. executed until you actually run the family.
  225.  
  226.                             ____________________
  227.  
  228. So far, so good. Take some time to play around, get the feel of things. When
  229. you are confident that this first parent screen has all the icons assigned and
  230. connected to all the correct children then click the right mouse button. You
  231. will now be presented with a new dialog box. The most important button here is 
  232. the SAVE button so we'll talk about it first:
  233.  
  234.  
  235. Saving the Completed Script
  236. ---------------------------
  237. When you choose SAVE from this dialog, Connections saves a complete script
  238. outlining every choice you've made relative to this parent screen. That
  239. includes filenames and all other important information. The script uses the
  240. same filename as your parent screen but adds the extension .SPT to the end. 
  241. .SPT scripts can be appended or replaced if you choose to load this parent
  242. screen again at a later date. 
  243.  
  244. Connections saves a second type of script with every multimedia child. These
  245. tiny scripts use the extension .SCR and they contain position data, speeds and
  246. other relevant information. 
  247.  
  248. Don't use a filename more than once within a Connections family, even if it
  249. has a different extension. A sound sample named FRED.SPL will use a script
  250. named FRED.SCR, but a graphic child named FRED.DAT will also need a script
  251. called FRED.SCR! Connections always uses the first eight letters of the
  252. multimedia childs filename to create a script.
  253.  
  254.  
  255. Changing a Connection
  256. -------------------- 
  257. If you wish to change a previous point and click area and its connection
  258. then choose the CHANGE button.
  259.  
  260. You will see all the point and click buttons turn inverse and a little sign
  261. appear over the top of each one showing what it is connected to. Just click the
  262. left mouse on top of the point and click area you wish to change or press the
  263. right button to cancel.
  264.  
  265. A dialog will appear showing the connection and asking if you wish to:
  266.  
  267.                              Erase this connection
  268.                              Retain this connection
  269.                              Assign a new position
  270.                                     Cancel
  271.  
  272. If point and click areas overlap, you will be asked about each connection in
  273. turn. Choosing "erase this connection" will delete the connection (but not the
  274. actual multimedia child). Choose "retain this connection" to continue
  275. unchanged to the next stacked connection. Choose "assign a new position" if
  276. you wish to define a new point and click area for this connection. Click
  277. "cancel" to quit making changes.
  278.  
  279.  
  280. Viewing Point and Click Buttons 
  281. ------------------------------- 
  282. You can view all the buttons you have created by clicking on BUTTONS. Just like
  283. the change option, all the defined areas will appear inverse with little signs
  284. showing their connections. Press the right mouse to exit this option.
  285.  
  286.  
  287. The Family Tree
  288. ---------------
  289. By clicking on this button you can view a flowchart of every parent screen
  290. within your family with every multimedia child that is attached. You can even
  291. choose to view individual types of multimedia children by clicking the left 
  292. mouse button or pressing any key. Click the right mouse to exit. 
  293.  
  294.  
  295. Load the Next Parent Screen
  296. ---------------------------
  297. Right after saving the script for your parent screen you will be asked if
  298. you wish to load the next parent screen. If you were creating a large family
  299. you could continue loading and saving all your parent screens until the family 
  300. was complete. Remember to keep everything in the same folder.
  301.  
  302. You can also discard the current parent screen and load another screen by 
  303. clicking LOAD within the dialog box. 
  304.  
  305.  
  306. Multiple Overlapping Connections 
  307. -------------------------------- 
  308. Connections allows you to assign more than one multimedia child to a given 
  309. area. If you drag out a defined area over top of an existing area you will 
  310. first be warned of this with a dialog box. You can then choose to place this
  311. new connection first or last. 
  312.  
  313. When running your family, you must manually exit a text child or an animation
  314. child before other stacked children can be displayed. If, for example, you
  315. connect a text file to a given area and on top of that place a sound sample,
  316. the user will first have to exit the text display window before the sound
  317. sample will play.
  318.  
  319. On the other hand, if the sound sample were first, it would begin playing
  320. and then display the text window. Most sound samples will play in the 
  321. background while other children are being displayed or even while other  
  322. mouse choices are made! 
  323.  
  324. Graphic children also require a mouse click to exit but not until all other
  325. stacked connections are displayed. For example, you could connect a graphic
  326. child to a given area and then place a text child on top. The graphic child
  327. would first be displayed and then immediately the text window would open over
  328. top of it. After exiting the text window you could still view the graphic
  329. child until you clicked the mouse. Now, if the graphic child were second in 
  330. the connection it would not be displayed until after the text window was 
  331. exited. 
  332.  
  333. With this in mind, you could stack multiple graphic children. All could be 
  334. displayed in different corners of the screen or overlap. After all were 
  335. displayed, only one keypress would be needed to exit. How about a long sound 
  336. sample at the beginning. The sample would play while the graphic children 
  337. were popping up all over the screen! 
  338.  
  339. Confused? Experiment with all the different multimedia children. Figure out 
  340. what works best for you. 
  341.  
  342.  
  343. ----------------------------------EXECUTION------------------------------------
  344.  
  345.  
  346. Running Connections Families
  347. ----------------------------
  348. Now we've completed our first Connections family, FUN WITH SASHA. Let's try
  349. it out! Any user having a copy of the Connections program can not only create,
  350. but also run anyone elses family. Simply choose RUN from the first dialog and
  351. then double-click on START.PI3 within the correct folder.
  352.  
  353. The parent screen will be displayed and you're off to the races! Users can
  354. click on any button and be presented with the multimedia child you have
  355. associated with it. Point and click to you hearts content. This is fun! What a
  356. neat way of displaying information.
  357.  
  358. Users also have access to the right mouse button dialog. They can view the
  359. family tree, display all the buttons (without the little signs) and even return
  360. to the previous parent screen or to the starting parent screen.
  361.  
  362.  
  363. Printing Graphic Images
  364. -----------------------
  365. If you call the right mouse button dialog or press P on the keyboard you can
  366. choose PRINT and send a hard copy of the current screen to your printer. This
  367. screen dump is Epson 9 pin compatible but there are many PD AUTO programs
  368. online that configure screen dumps for other makes and models.
  369.  
  370. You can press P within text windows to print ASCII files, within running
  371. animations to print one of the cells, while graphic children are displayed or
  372. within any parent screen.
  373.  
  374.  
  375. Auto Running Families
  376. ---------------------
  377. You can use INSTALL APPLICATION from the Atari desktop so that the Connections
  378. program will auto-run when you click on any START.PI3 file. 
  379.  
  380. TOS 2.05 and 2.06 users should highlight CONNECT.PRG from the desktop and then 
  381. click on "install application" from the menu "options". The dialog should then 
  382. be set to:
  383.                          Application name: CONNECT.PRG 
  384.                                 Arguments: ___________
  385.                             Document type: PI3 
  386.                                Install as: F__ 
  387.                               Boot status: Normal
  388.                          Application type: GEM 
  389.                               Default dir: Application
  390.                                 Parameter: Full Path 
  391.  
  392. Click on INSTALL and then save your desktop to make the changes permanent. 
  393.  
  394. Users of the newdesk TOS 2.06 can also "drop" START.PI3 right on top of the
  395. Connections program icon and have it auto-run.
  396.  
  397. The last method of auto-running a family is to place CONNECT.PRG and 
  398. CONNECT.RSC within the folder that contains START.PI3 and your family. If 
  399. Connections finds START.PI3 within the same folder/directory as itself, it 
  400. will immediately run that family.
  401.  
  402.  
  403. In Closing 
  404. ---------- 
  405. I hope you enjoy Connections. Don't hesitate contacting me on GEnie (D.Becker8)
  406. or Compuserve (73030,3562). If you have no way of sharing your Connections
  407. families with other Atari users then send me a disk in the mail and I'll upload
  408. your creation for everyone.
  409.  
  410.                                           David Becker 
  411.                                           211-7291 Moffatt Road
  412.                                           Richmond, British Columbia 
  413.                                           Canada, V6Y 1X9 
  414.